home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / diskutil / fileutil.lzh / MANUAL.DOC < prev    next >
Text File  |  1986-10-19  |  14KB  |  258 lines
  1. ===========================================================================
  2.  
  3.     Veronly is a Public Domain subset of Verify.ttp which is
  4.     copyrighted and will be part of a future hard disk utility
  5.     package.  If you desire to have a copy now, contact me on
  6.     any of several ST BBS's that PC Pursuit reaches or write:
  7.  
  8.     Thomas Zerucha
  9.     24075 Lee Baker
  10.     Southfield, MI 48075
  11.  
  12. ===========================================================================
  13. VERIFY.TTP - Disk file structure diagnostic and repair
  14. VERonly.TTP - Does everything but repair - diagnoses disk structure problems.
  15.  
  16.      GEMDOS format verify/repair utility
  17.      Format verification for all known volumes
  18.      Can be used in /auto, change to verify.prg
  19.      If no parameter is specified, the verify mode is entered:
  20.           Lists disks logged in system, and any errors found on them.
  21.           Tests performed:
  22.                FATs identical
  23.                FATs have no invalid links
  24.                Directory entry begins at beginning of FAT chain
  25.                Subdirectories link properly (. and .. files)
  26.                Directory entry size consistent with number of clusters used
  27.                Single Volume Label
  28.                No used clusters without files
  29.           Any of these errors will cause an error message, in addition, any
  30.                files threatened may be listed.  If no disk is in a drive, a
  31.                message will be printed, but not as an error.
  32.           If no errors exist on any disks, the program will end normally,
  33.                (back to desktop or shell) otherwise a list of disks with
  34.                errors will be printed and the program will pause until any
  35.                key is pressed.
  36.           Use redirection to produce a log, but remember to hit a key to end
  37.                the pause on error (e.g.)
  38.                (verify.ttp) >a:verlog.txt
  39.           Remember that NO OPTIONS are allowed in this mode, if they are
  40.                specified, they will normally be ignored.
  41.  
  42.      Parameters (any order):
  43.           [<drive>]
  44.           <drive> is which drive to analyze and repair
  45.           [-<option list>]
  46.           you may use any number of options, with one or more hyphens,
  47.           e.g. -p -r is equivalent to -rp, but all require an explicit drive
  48.           to be specified
  49.           options:
  50.                -r   repair the disk (if not specified, only a verify
  51.                     is performed and log information printed)
  52.                -f   print out fat
  53.                -d   print a directory
  54.                -p   print all information
  55.                -e   list threatened files only
  56.                -s   single drive mode (pauses to allow disk change)
  57.                -x   allocates more memory (dir is much bigger than FAT says)
  58.                     (you will be prompted if this is needed)
  59.  
  60.      Statistics:
  61.           FAT:
  62.                Tot(al) - number of clusters on disk
  63.                Starts  - number of clusters that begin chains
  64.                Ends    - number of EOF markers
  65.                erend   - number of chains ending at an invalid cluster
  66.                inval   - number of invalid clusters (not free, next, or EOF)
  67.                colls   - number of collisions (chains merge)
  68.                cont    - number of contiguous clusters
  69.                ncont   - number of non-contiguous clusters
  70.  
  71.           The FAT is stored as a linked list.  Each chain should have one
  72.           beginning and end at an EOF marker.  All other clusters are marked
  73.           reserved/bad or free and should not be part of any chain.  If a
  74.           cluster points to the one following it, it is considered contiguous,
  75.           otherwise, if it is not an EOF it is non-contiguous.  Contiguous
  76.           chains are faster to access.
  77.  
  78.           Cross Reference Statistics:
  79.  
  80.                Files - total number of files in directory and FAT
  81.                Fclus - clusters allocated to known files
  82.                Free  - available clusters
  83.                oclus - "orphan" clusters - allocated, but no file uses them
  84.                recov - Neither file nor orphan, recoverable
  85.                unuse - reserved clusters (normally bad blocks)
  86.                unkn  - unknown (deeper xref necessary, done in repair)
  87.                orphs - number of "orphan" files
  88.                ordec - decendents of orphan directory
  89.                error - number of threatened or bad files
  90.                Noerr - number of perfect files.
  91.  
  92.           Each beginning and ending in the FAT is matched with the directory,
  93.           and any differences noted.  If a chain is allocated, but no
  94.           directory entry matches, it is flagged as an "orphan".  This can
  95.           occur when deletes are interrupted.  If a free block ends a file
  96.           chain, it's status is unknown, but can be resolved futher.  Since
  97.           it is neither Free or allocated, it is counted "unkn".  Further
  98.           repair will either change it to EOF or Free.  This applies to
  99.           some other situations.  Recoverable is not marked free, but cannot
  100.           (or should not) be recovered into a file, but will be marked free
  101.           when repaired.
  102.  
  103.           This information may not be of interest except to users who
  104.           know about GEMDOS and may want to do some editing with other
  105.           tools to manually restore some files.  Otherwise it useful only
  106.           to point out which files may be invalid or altered, and those
  107.           which are created by the utility.  It will also indicate the
  108.           general health of the disk if repair is not specified.
  109.  
  110.           A list of the threatened files will be produced if the E option
  111.           is specified.
  112.  
  113.           Orphan files may be deleted if necessary.  Since it is not possible
  114.           to know if the file was really deleted or the directory entry
  115.           was trashed, the files are just recovered (with a guess as to the
  116.           type).  If nothing was missing these are probabaly files which
  117.           the delete merely failed to complete, so the space should be
  118.           recovered by deleting the files.  Otherwise (e.g. if a source
  119.           file was missing and FIX_xxxx.TXT appears) look at or run (carefully,
  120.           since programs may delete some files) the file to see what happens.
  121.           Orphan descendants occur when the entry for a directory is missing
  122.           or erased.  The file is recovered as a directory, and the directory
  123.           is read and any files within are recovered.
  124.  
  125.           Collisions occur when two files link through the same cluster.  The
  126.           part of the file left usually belongs only to one of these files,
  127.           but deleting the other file will remove this area as well.  The
  128.           FAT chain is cleaved based on the most likely owner.  A related
  129.           problem is a bad end, the last cluster in the file is not the EOF
  130.           mark, but a free cluster (which can be allocated by another file
  131.           causing a collision), or points outside of the storage area of the
  132.           disk (e.g track 120 on an 80 track disk).  These are changed to EOF's
  133.           or the cluster pointing to this end is changed to EOF.
  134.  
  135.           If repair is specified, the following log will be added:
  136.  
  137.           Repair info:
  138.                     comments will be indented
  139.                <path>, bad start, removed
  140.                <path>, excessive size, removed
  141.                     first, any invalid files are removed from the root to make
  142.                     room for any directories that need to be created (in case
  143.                     the root is wiped and has no available entries).  THIS WILL
  144.                     ALSO REMOVE THE VOLUME LABEL.  The tests for validity are
  145.                     simple at this point, only something obvious is zapped
  146.                <path>, inserting as directory
  147.                     directories that have been found are restored
  148.                Resolving duplicate starts
  149.                <path>
  150.                <path>
  151.                . . .
  152.                     more than one directory entry start at the same
  153.